home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / misc / seek / help next >
Encoding:
Text File  |  1994-08-10  |  11.2 KB  |  288 lines
  1. Overview
  2. ========
  3.  
  4. SEEK is a utility for looking up Bible references.
  5.  
  6. If you can't quite remember that verse that says something about how much
  7. God loved the world, then enter up to three words that you think are in the
  8. verse, "God", "loved" and "world" and SEEK will quickly find:-
  9.  
  10. John 3:16   For God so loved the world, that he gave his only begotten Son,
  11.      that whosoever believeth in him should not perish, but have everlasting
  12.      life.
  13.  
  14. SEEK supports interactive help.
  15.  
  16. RISC OS 2
  17. =========
  18.  
  19. It is doubtful as to whether SEEK will operate under RISC OS 2. All my
  20. friends have now upgraded to RISC OS 3, so it's not easy for me to check.
  21.  
  22. Installation
  23. ============
  24.  
  25. SEEK is provided as an archived file on a 1.6Mb floppy disk. It is possible
  26. to operate SEEK from the archive on the floppy disk, using !ArcFS. When
  27. operating in this way, the speed of SEEK will be limited by the speed at
  28. which the data can be read from the floppy disk.
  29.  
  30. To install SEEK on a hard disk, simply open the archive and drag the !SEEK
  31. application directory onto your hard disk.
  32.  
  33. How to use it
  34. =============
  35.  
  36. Double-click on the !SEEK icon. After a few seconds SEEK will appear on the
  37. icon bar.
  38.  
  39. Click on the icon bar. The SEEK Control window will appear.
  40.  
  41. Enter the words you want into the three writable icons, then click on the
  42. Seek button to start the search. SEEK will then find all the verses which
  43. contain all the specified words.
  44.  
  45. SEEK will indicate its progress in a separate progress window.
  46.  
  47. When SEEK has completed its search, it will open a display window containing
  48. the verses it has found. 
  49.  
  50. The verses that have been found can be saved to a file, or to another
  51. application, by using the SAVE option from the menu. Drag the output file
  52. from the save box to a filer window, or into an EDIT document, or onto the
  53. EDIT iconbar icon.
  54.  
  55. Hints
  56. =====
  57.  
  58. In some cases, it might be reasonable to search for a single word, if the
  59. word doesn't occur too many times in the Bible. Enter the word into one of
  60. the three writable icons, and leave the others blank.
  61.  
  62. If this produces too much output, then you should refine your search
  63. criteria by adding a second or third word in the other writeble icons. SEEK
  64. will display only those verses which contain all of the specified words.
  65.  
  66. Alternatively, you can reduce the amount of output by restricting the search
  67. to only part of the Bible by using the SELECTION option from the menu.
  68.  
  69. In general, it is not a good idea to include very common words, like "the",
  70. in your search criteria.
  71.  
  72. Words
  73. =====
  74.  
  75. SEEK only searches for complete words. If searching for "righteous" it will
  76. completely ignore any occurrences of "unrighteous", "righteousness",
  77. "righteously" etc.
  78.  
  79. If you spell a word incorrectly, or enter a word that does not occur
  80. anywhere in the Bible, then SEEK will immediately recognise that the word is
  81. not in its dictionary, and not bother to perform the search.
  82.  
  83. SEEK ignores the difference between upper and lower case. 
  84.  
  85. Be aware that the spelling of some words has changed since the King James
  86. Version of the Bible was produced. SEEK will only recognise the original KJV
  87. spelling.
  88.  
  89. Using a wildcard in the WORDCOUNT option may help you check your spelling.
  90.  
  91. Menu Options
  92. ============
  93.  
  94. Clicking with the middle mouse button over any SEEK window will bring up the
  95. menu. The menu options are:-
  96.  
  97.     INFO  Tells you a little bit about SEEK
  98.  
  99.     SAVE  Opens the save box.
  100.           Drag the file to a filer window, or to a text editor.
  101.  
  102.           The contents of the output buffer remain unchanged until you
  103.           perform another search, so it is possible to save several copies
  104.           of the same output without re-seeking. So, if you don't like the
  105.           format, you can change the format options and re-save without
  106.           re-seeking.
  107.  
  108.     SELECTION Opens the selection window. 
  109.  
  110.           If you want to limit your search to part of the Bible, either for
  111.           speed, or because there are too many occurrences of your target
  112.           words, then use this window to switch off the parts that you wish
  113.           to exclude from the search.
  114.  
  115.           By default the whole Bible is searched.
  116.  
  117.     WORDCOUNT Opens the word count window.
  118.  
  119.           If you want to know how many times a particular word occurs in the
  120.           Bible, then type it into the WORD COUNT window and press RETURN.
  121.           The number of occurrences will then be displayed.
  122.  
  123.           The LAST character may be the wildcard asterisk "*", e.g. "right*"
  124.           will match all words like "righteous", "righteousness" etc. All
  125.           the words which match the pattern are detailed in the output
  126.           window, and the total number of occurrences for all matching words
  127.           appears in the wordcount window. If there are more than 1000
  128.           matching words, only the first 1000 will be displayed.
  129.  
  130.           NOTE: The WORD COUNT operation is not affected by the current
  131.           settings in the SELECTION window. It always gives the number of
  132.           words in the entire Bible.
  133.  
  134.           NOTE: If a word occurs twice in one verse, then the number of
  135.           word occurrences shown in the word count window will differ from
  136.           the number of verses found by a SEEK operation searching for the
  137.           word.
  138.  
  139.     EXPORT Opens the export window.
  140.  
  141.           The export window allows you to save passages of text into a text
  142.           file or into another application.
  143.  
  144.           There are three pieces of info to specify: BOOK, FROM and TO.
  145.  
  146.           BOOK: Click SELECT on the menu icon [⇨]. Select a book from the
  147.                 menu which will then appear.
  148.  
  149.           FROM: Enter the chapter:verse numbers where the chunk starts.
  150.  
  151.           TO:   Enter the chapter:verse numbers where the chunk ends.
  152.  
  153.           To specify an entire book, enter "1:1" in the FROM icon, and
  154.           "999:999" in the TO icon. 
  155.  
  156.           Once these are filled in, click SELECT on the SAVE icon. At this
  157.           point the values you typed into the icons will be validated, and
  158.           an error produced if the from and to values are not correctly
  159.           formatted. If the values are valid, then a save box is opened.
  160.           Drag the save box to a directory or a text editor application.
  161.  
  162.     FORMAT opens the format control window. You can use this to modify the
  163.           format of the saved and exported text.
  164.  
  165.           The format control window has four sections:-
  166.  
  167.              SAVE TEXT controls the layout of the text of a saved file.
  168.  
  169.              EXPORT TEXT controls the layout of the text of an exported
  170.              file.
  171.  
  172.              EXPORT REF controls the references used in an exported file.
  173.  
  174.              SPECIAL FX can be used to insert special control strings.
  175.  
  176.           Saved text always has a full reference.
  177.  
  178.              • SINGLE SPACED - each verse starts on a new line
  179.              • DOUBLE SPACED - a blank line after each verse
  180.              • NO TEXT       - only the reference will be saved, not the
  181.                                text
  182.              • CONTINUOUS    - no new lines
  183.  
  184.  
  185.              • FULL REFERENCE - like "1 Chron 5:2 "
  186.              • CHAPTER:VERSE  - like "5:2 "
  187.              • VERSE          - like "2 "
  188.              • NO REFERENCE   - reference numbers are omitted
  189.  
  190.           The SPECIAL FX are
  191.  
  192.              • IMPRESSION SUPER - when loaded into Impression, the
  193.                references will have the "superscript" effect.
  194.              • IMPRESSION REF - Open an Impression document and create a
  195.                style called "Reference", THEN when the references are loaded
  196.                into the document they will be in the "Reference" style. ((If
  197.                you load the text in first, then create the style, Impression
  198.                can get very confused))
  199.              • ANGLES - The references appear between sets of angle
  200.                brackets.
  201.  
  202.              Expert users are invited to configure their own special
  203.              effects by editing the CONFIG file, details are at the end of
  204.              the "Technical" document.
  205.  
  206.     QUIT  terminates the program
  207.  
  208. Progress Messages
  209. =================
  210.  
  211. "WAITING: No target words selected" You have attempted to perform a SEEK
  212. without entering anything to search for.
  213.  
  214. "SEEK COMPLETED: Word 'xxxxxxxxxx' never occurs" One of the words that you
  215. are trying to search for is not in SEEK's dictionary. SEEK's dictionary
  216. contains all the words that occur in the Bible. You may have spelled the
  217. word incorrectly (or perhaps just differently from the KJV spelling).
  218.  
  219. "SEEKING 'xxxxxxxx'" This is displayed when a search has just started. The
  220. word indicated is being used as the primary search criterion. The primary
  221. search criterion is the least commonly occurring word entered. E.g. if you
  222. search for "throne", "rainbow", "sardine" then SEEK will say "SEEKING
  223. 'sardine'" because the Bible refers to "sardine" fewer times than "throne"
  224. or "rainbow".
  225.  
  226. "SEEKING: Found XXX 99:99: Found XXXX occurrences so far" Indicates the
  227. current progress of the search.
  228.  
  229. "COMPLETED: Found XXXX occurrences" The search has completed. The number of
  230. verses that match the criteria is displayed. Note: for a one-word search
  231. this may not be the same as the number of occurrences of the word itself,
  232. since the word may occur more than once is some verses. 
  233.  
  234. "STOPPED: Output buffer is full" The output buffer has used up the 1000
  235. lines of text, which is its maximum capacity. (I could make it bigger, but
  236. each additional 12 lines of text requires an additional 1k of WimpSlot
  237. memory, and I wanted SEEK to work on a 1Mb machine). The first 1000 lines of
  238. output are available for viewing and saving.
  239.  
  240. Apostrophes
  241. ===========
  242.  
  243. To search for a word that contains an apostrophe, enter the whole word
  244. including the apostrophe. E.g. "Peter's". N.B. searching for "Peter" will,
  245. unfortunately, not find "Peter's". SEEK considers these to be two completely
  246. different words.
  247.  
  248. The program has a little bit of difficulty working with words which have a
  249. TRAILING apostrophe ("The Jews' feast of Tabernacles", "Moses' disciples").
  250. It is not possible to distinguish a trailing apostrophe from a single-quote.
  251. (He said, "They told me 'We are Jews'"). The program gets round this by
  252. ignoring trailing apostrophes when searching. The words "Jews'" and "Jews"
  253. are considered to be the same word.
  254.  
  255. Hyphenated words
  256. ================
  257.  
  258. SEEK considers hyphenated words to be two separate words. E.g. to find the
  259. word "God-ward" you should search for the two separate words "God" and
  260. "ward".
  261.  
  262. Contact
  263. =======
  264.  
  265. If you use this program seriously, please do get in contact with me, and let
  266. me know what features you would like adding, and report any bugs you find. A
  267. list of possible new features is listed in the IDEAS file inside the
  268. application, but I'm only going to program them in if people like yourself
  269. say that you would use them.
  270.  
  271. You may also be interested in contacting the Christian Acorn Users Group
  272. (c/o Rev. Colin Randall, The Rectory, Swan Lane, Long Hanborough, Witney
  273. OX8 8BT) who's newsletter inculdes information regarding similar products.
  274.  
  275. Copyright
  276. =========
  277.  
  278. This program is FREEWARE. That means that the author retains the copyright
  279. to the program, but that you may copy and distribute it freely.
  280.  
  281. Please don't distribute modified versions of the code. If you want to fix
  282. bugs or add features get in contact with me first - I may already have fixed
  283. it.
  284.  
  285. Mike Williams
  286. 111 Evering Road
  287. LONDON N16 7SL
  288.